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GAM0183 Game Programming 


Lecture 8 


INFORM 7 Language — Light Puzzles 


INFORM 7 is the most natural language-like programming language in the world. 


based on Inform 7 Examples & Snippets @ hitp://www.hpiweb.com/newmedia/ 
by John Timmons 
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Light switch outside room P 


e Rooms are lit by default. 
e A player cannot see or interact with anything in a dark room. 


[The room description is only be displayed if there is light.] 

The Kitchen is north of the Foyer. The Kitchen is dark. 'There is a table and 
four i a cooker, freezer, and a washing machine. There is an exit to the 
south.” 


e Sometimes a light switch is located outside a room and must be 
switched on before entering the room. 


e In INFORM 7, it is appropriate to define a light switch as a device. 


INFORM 7 ‘definition’ : device 
device, a kind of thing (plural devices) 


Represents a machine or contrivance of some kind which can be switched on or off. 
Usually switched off not switched on. 
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[This is the start room. Note that the room description hints at a light switch. ] 
The Foyer is a room. "An empty room except for a switch on the wall. There is an 
exit to the north." 


LightSwitchOutsideRooin 


[The switch is made scenery so it cannot be taken. The switch is in the Foyer in 
order to be able to see it. ] 
The wall switch is a device in the Foyer. It is scenery. It is switched off. 


[Switching on the wall switch gives the Kitchen room light. ] 
Carry out switching on the wall switch: 


[Switching off the wall switch puts the Kitchen room into darkness] 
Carry out switching off the wall switch: 
now the Kitchen is dark. 


[The room description is only be displayed if there is light. ] 
The Kitchen is north of the Foyer. The Kitchen is dark. "There is a table and four 
chairs, a cooker, freezer, and a washing machine. There is an exit to the south." 


[A message if the player tries to exit the room in directions that do not exist. ] 
Instead of going nowhere from the Kitchen when in darkness: 
say "Stumbling around in the dark will get you nowhere." 


Foyer 

An empty room except for a switch on the wall. There is an exit to the north. 
>north 

Darkness 

It is pitch dark, and you can't see a thing. 

>east 

Stumbling around in the dark will get you nowhere. 

>south 

Foyer 

>switch on switch 

You switch the wall switch on. 

>north 

Kitchen 

There is a table and four chairs, a cooker, freezer, and a washing machine. There is an 
exit to the south. 

>south 

Foyer 

>switch on switch 

That's already on. 


play 


Testing interactive fiction 


“The only way to thoroughly test a work of IF is to run a 
complete solution through it, and carefully check the 
resulting transcript of dialogue. The Skein and Transcript 
tools of the Inform application are provided for exactly this 
purpose.” - INFORM 7 Manual section 2.3 The TEST command 

Test scripts can also be written to test short sequences of 
interaction. 


Test ee with "take aot / examine flashlight / go north / 
turn on flashlight / turn off flashlight". 


Typing “Test Flashlight” when the game is being played will 
execute the associated script. 


Typing just “Test” will list the available test scripts. 
The name of a test has to be a single word. 
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Taking a flashlight into a room 


Rooms are lit by default. 
A player cannot see or interact with anything in a dark room. 


[The room description is only be displayed if there is light.] 

The Kitchen is north of the Foyer. The Kitchen is dark. 'There is a table and 
four i a cooker, freezer, and a washing machine. There is an exit to the 
south.” 


A thing with the property of being "lit" will enable the player to see 
inside dark rooms, and to carry out other activities requiring light, 
such as examining items. A lit thing in an open container will still light 
up a room; a lit thing in a closed container will not, unless the 
container has been given the "transparent" property. - INFORM 7 Manual 
section 3.15 Light and Darkness 

In INFORM 7, it is appropriate to define a flashlight as a device (which 
is a kind of thing). 


Properties depend on kind. 
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INFORM 7 ‘definition’: thing 


thing (plural things) 

Represents anything interactive in the model world that is not a room. 
People, pieces of scenery, furniture, doors and mislaid umbrellas might 
all be examples, and so might more surprising things like the sound of 
birdsong or a shaft of sunlight. 

Usually unlit not lit, inedible not edible, portable not fixed in place 
singular-named not plural-named, improper-named not proper- 
named, described not undescribed, unmarked for listing not marked 
for listing, mentioned not unmentioned. 

Usually not scenery, wearable, pushable between rooms, handled, 
initially carried. 

Can have description (some text), printed name (some text), indefinite 
article (some text), initial appearance (some text), printed plural name 
(some text), matching key (the name of an object). 


Use full-length room descriptions, and no scoring. Flashlight 


[This is the start room.] 
The Foyer is a room. "A empty room. There is an exit to the north." 


[A flashlight is located in the Foyer.] 
A flashlight is a device in the Foyer. "The heavy duty flashlight could easily light up a 
room." 


[Switching on the flashlight gives it the lit property so it will provide light.] 
Carry out switching on the flashlight: 
now the flashlight is lit. 


[Switching off the flashlight gives it the dark property so it will no longer provide light. | 
Carry out switching off the flashlight: 

now the flashlight is dark. 
[Note the default response when you turn off a portable light source in a dark room.] 


[The Kitchen is a dark room. | 
The Kitchen is north of the Foyer. The Kitchen is dark. "There is a table and four chairs, a 
cooker, freezer, and a washing machine. There is an exit to the south." 


Test FlashLight with "take flashlight / examine flashlight / go north / turn on flashlight / 
turn off flashlight”. 
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Foyer 

A empty room. There is an exit to the north. 

The heavy duty flashlight could easily light up a room. 
>Test 

>--> The following tests are available: 
‘test FlashLight' 

>Test Flashlight 

(Testing.) 

>[1] take flashlight 

Taken. 

>[2] examine flashlight 

The flashlight is currently switched off. 
>[3] go north 

Darkness 

It is pitch dark, and you can't see a thing. 
>[4] turn on flashlight 

You switch the flashlight on. 

Kitchen 

There is a table and four chairs, a cooker, freezer, and a washing machine. There is an 
exit to the south. 

>[5] turn off flashlight 

You switch the flashlight off. 
It is now pitch dark in here! 


e Note that dealing with time in any game can be complicated. 
e In INFORM 7, the time play starts can be changed: 


[By default, all games begin at 9:00 AM. ] 
When play begins: change the time of day to 2:50 PM. 


e 2:50 PM is a kind of value called time and “time of day” is a 
time that varies. 


e In INFORM 7, each turn takes one minute. 


e “In some works of interactive fiction, time of day is crucial: in 
others, it is irrelevant or even, by a sort of tacit convention, 
non-existent.” - INFORM 7 Manual section 9.6 The time of day 
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Use no scoring. LightForAFewMinutes 
[By default, all games begin at 9:00 AM.] : 
When play begins: change the time of day to 2:50 PM. 


When play begins: 
decrease turn count by 1; 
[Normally just starting the game counts as 1 turn. | 
change the left hand status line to 
"[the player's surroundings] - Turns: [turn count]"; 
change the right hand status line to "Time: [time of day"; 
say "You have until 2:55 PM to figure a way out before the torch 


burns out and leaves you in the dark for all eternity./ paragraph break]" 


[This is the start room. ] 
The Foyer is a room. It is dark. "The foyer is empty except for a flaming 
torch attached to the wall." 


[The torch initially provides light in the room.] 
A torch is scenery in the Foyer. It is lit. 


Instead of taking the torch: 
say "Try as you might, the torch is firmly attached to the wall." 
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[At various times, messages are displayed about the status of the torch.] 
Every turn: 
if the time of day is 2:52 PM 
begin; 
say "The torch starts to flicker."; 
otherwise if the time of day is 2:53 PM; 
say "The torch sputters and the flame begins to diminish."; 
otherwise if the time of day is 2:54 PM; 
say "The last flames of the torch flicker out..."; 
now the torch is dark; 
otherwise if the time of day is 2:55 PM; 
end the game in death; 
end if. 


Foyer - Turns: @ Time: 2:50 pm 


You have until 2:55 PM to figure a way out before the torch burns out and leaves you in the dark for all eternity, 
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Foyer 


The foyer is empty except for a flaming torch attached to the wall. 


>take torch 
Try as you might, the torch is firmly attached to the wall. 
>north 
You can't go that way. 
>south 
You can't go that way. 
The torch starts to flicker. 
>east 
You can't go that way. 
The torch sputters and the flame begins to diminish. 
>west 
You can't go that way. 
The last flames of the torch flicker out... 
It is now pitch dark in here! 
>up 
You can't go that way. 
*** You have died *** 


just prior to the time being updated. 
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Every turn rules are applied at the end of a turin 


2:50PM 
2:51PM 


2:52PM 
2:53PM 


2:54PM 


2:55PM 


play . 


Limited flashlight based on the 
number of turns. 


e A flashlight device can be given a charge. 


[The flashlight is given a variable called charge that holds a 
numerical value.] 

A flashlight is a device in the Foyer. The flashlight has a number 
called charge. The charge of the flashlight is 5. 


e At each turn, the charge can be reduced by one. 
decrease the charge of flashlight by 1; 

e Depending on the charge, a message can be displayed to the player. 
if charge of flashlight is 2 use IS not == 


begin; 
say "The flashlight seems to be getting dimmer."; 
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The Foyer is a room. "The foyer is empty except for a bottle of whisky on the 
LimitedFlasilight 


floor. There is an exit to the north." 


The Kitchen is north of the Foyer. It is dark. "There is a table and four chairs, a 
cooker, freezer, and a washing machine. There is an exit to the south." 


[The flashlight is given a variable called charge that holds a numerical value. | 
A flashlight is a device in the Foyer. The flashlight has a number called charge. 
The charge of the flashlight is 5. 


Before switching on the flashlight: 
if charge of flashlight is 0 
begin; 
say "It's no use. This flashlight is dead as a doornail."; 
stop the action; 
otherwise if flashlight is switched on; 
say "The flashlight is already switched on."; 
stop the action; 
otherwise; 
now the flashlight is lit; 
continue the action; 
end if. 
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Carry out switching off the flashlight: 
now the flashlight is dark. 


Every turn: 
if charge of flashlight is greater than 0 
begin; 
if flashlight is switched on 
begin; 


decrease the charge of flashlight by 1; 
if charge of flashlight is 2 


begin; 
say "The flashlight seems to be getting dimmer."; 
otherwise if charge of flashlight is 1; 

say "The flashlight is getting very dim."; 
otherwise if charge of flashlight is 0; 

say "The flashlight dies out."; 

now the flashlight is dark; 

end if; 
end if; 
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Foyer 

The foyer is empty except for a bottle of whisky on the floor. There is an exit to the north. 
You can see a flashlight here. 

>take flashlight 

Taken. 

>switch on flashlight 

You switch the flashlight on. 

>examine flashlight 

The flashlight is currently switched on. 

>north 

Kitchen 

There is a table and four chairs, a cooker, freezer, and a washing machine. There is an exit 
to the south. 

The flashlight seems to be getting dimmer. 

>south 

Foyer 

The flashlight is getting very dim. 

>north 

Kitchen 

The flashlight dies out. 

It is now pitch dark in here! 

>look 

Darkness 

It is:pitch dark, and you can't see a thingodr Andy Brooks 


Foyer 

The foyer is empty except for a bottle of whisky on the floor. There is an exit to the 
north. 

You can see a flashlight here. 

>take whisky 

You can't see any such thing. 

>turn on flashlight 

You switch the flashlight on. 

>look 

Foyer 

The foyer is empty except for a bottle of whisky on the floor. There is an exit to the 
north. 

You can see a flashlight here. 

>take whisky 

You can't see any such thing. 

>remove mask 

You can't see any such thing. 

>examine myself 

As good-looking as ever. 

The flashlight seems to be getting dimmer. 


red herrin ig play 
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